You are here: Available Utilities > A > ARCRET > Using the Plug-ins > PLGGenPrint

Using the PLGGenPrint Plug-in

This plug-in accepts output from the ARCRET utility and executes the GenPrint program to produce printed output of archived transactions.

Note Before you use this plug-in, make sure you have a batch setup that can run the GenPrint program to produce the printed output you want.

To specify this plug-in, include these INI settings:

< ArcRet >

   PlugInMod = PLGW32.DLL

   PlugInFunc = PLGGenPrint

Note that case is important when specifying the name of the plug-in. You must specify it exactly as shown here.

The ARCRET utility produces an NA/POL file set similar to that produced by the GenData program. This includes a NewTrn file that is created from the archive index using the options in the Trigger2Archive control group. The plug-in then converts the NewTrn file into a batch (RCBDFDFL.DFD) compatible file and starts the GenPrint program to complete the process.

The conversion from the NewTrn type output of the ARCRET utility to a recipient batch file is accomplished by matching the field names between the two files. No addition INI options are necessary. The utility simply uses the TRNDFDFL.DFD file and the RCBDFDFL.DFD file (or whatever names you give these files in your INI settings) and match the fields by name. The utility automatically handles any other necessary conversions.

The plug-in produces a recipient batch record for each recipient found in the form set associated with the transaction. Because only one batch file is produced, all recipients are written to the same file.

Once the batch file is produced, the utility internally re-maps the INI options for the following items, writes a temporary INI file, and then executes the GenPrint program specifying that INI file to produce the batch output.

< Environment >

   FSISYSINI =

< Print_Batches >

   ...

< Exclude_Batches >

...

< Data >

   NAFile =

   POLFile =

   NewTrn =

Option

Changes

Environment control group

FSISYSINI

This option is eliminated. All of the current options from both INI files were placed in memory while executing the ARCRET utility, so the file is not necessary in the subsequent run of the GenPrint program.

Print_Batches control group

all options

All batches defined under this group are eliminated except for the first alphabetical group. The utility uses the first option as the batch to be processed. Make sure the printer settings for this batch are appropriate. The utility changes the name of the BCH file associated with this option to match the file produced by the plug-in.

Exclude_Batches control group

all options

The utility eliminates all of the options in the control group to make sure the one batch left intact is processed.

Data control group

NAFile

This option is changed to match the output from the ARCRET utility.

POLFile

This option is changed to match the output from the ARCRET utility.

NewTrn

This option is changed to match the output from the ARCRET utility.

In general, all the temporary files that are produced have the same (8-digit hexadecimal) name and a different extension. This includes the temporary INI file the utility produces for the GenPrint program.

If GenPrint errors occur, remember the output of the GenPrint program is written to the error file specified in the Data control group and is not controlled by the plug-in or the ARCRET utility.